<html>
<head><meta charset="utf-8"><title>Recruiting new rustdoc members · rustdoc · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/index.html">rustdoc</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html">Recruiting new rustdoc members</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="217760121"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217760121" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217760121">(Nov 24 2020 at 14:25)</a>:</h4>
<p>After the conversation in <a href="#narrow/stream/245100-t-compiler.2Fwg-prioritization.2Falerts/topic/I-prioritize.20.2379103.20Rustdoc.20takes.208.2E5.20GB.20of.20memory.20to.20docum.E2.80.A6">https://rust-lang.zulipchat.com/#narrow/stream/245100-t-compiler.2Fwg-prioritization.2Falerts/topic/I-prioritize.20.2379103.20Rustdoc.20takes.208.2E5.20GB.20of.20memory.20to.20docum.E2.80.A6</a>, <span class="user-mention" data-user-id="250987">@apiraino</span> suggested that we start recruiting new people for rustdoc so I don't feel like I'm trying to do everything myself. We were thinking of writing a blog post in the spirit of <a href="https://blog.rust-lang.org/2020/09/14/wg-prio-call-for-contributors.html">https://blog.rust-lang.org/2020/09/14/wg-prio-call-for-contributors.html</a> with vaguely this info:</p>
<ol>
<li>What rustdoc is and why it's important</li>
<li>How you can help</li>
</ol>
<p>It would be nice as part of 2. to also tag some issues as E-mentor.</p>



<a name="217760176"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217760176" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217760176">(Nov 24 2020 at 14:25)</a>:</h4>
<p>one thing we discussed is that both <a href="http://docs.rs">docs.rs</a> and rustdoc could really use a changelog, right now there are a lot of changes coming in that aren't documented terribly well</p>



<a name="217760254"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217760254" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217760254">(Nov 24 2020 at 14:26)</a>:</h4>
<p>and the nice thing about that is it doesn't require any experience, you just search <code>label:T-rustdoc is:pr is:merged</code></p>



<a name="217760319"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217760319" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> simulacrum <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217760319">(Nov 24 2020 at 14:27)</a>:</h4>
<p>I would suggest against framing this specifically as a "new team members" thing, but more so that you're looking for contributors. Along side that you can publish a "pathway to membership" (e.g., frequent contributor over 2-3 months and contributes to design discussion)</p>



<a name="217760364"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217760364" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217760364">(Nov 24 2020 at 14:27)</a>:</h4>
<p>right, that's what I meant. I like the pathway to membership idea :)</p>



<a name="217760463"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217760463" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217760463">(Nov 24 2020 at 14:28)</a>:</h4>
<p>we have been getting a fair amount of new contributors lately so I think there's already interest if we can get the word out</p>



<a name="217765434"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217765434" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217765434">(Nov 24 2020 at 15:04)</a>:</h4>
<p>hello</p>



<a name="217765623"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217765623" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217765623">(Nov 24 2020 at 15:06)</a>:</h4>
<p><span aria-label="wave" class="emoji emoji-1f44b" role="img" title="wave">:wave:</span></p>



<a name="217766129"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766129" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766129">(Nov 24 2020 at 15:10)</a>:</h4>
<p>Welcome! Are you looking to work on rustdoc?</p>



<a name="217766178"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766178" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766178">(Nov 24 2020 at 15:10)</a>:</h4>
<p>yeap</p>



<a name="217766204"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766204" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766204">(Nov 24 2020 at 15:10)</a>:</h4>
<p>I've been reading about it.</p>



<a name="217766323"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766323" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766323">(Nov 24 2020 at 15:11)</a>:</h4>
<p>I need to start diving into the code now, to see what that clean::DocContext does.. <span aria-label="smile" class="emoji emoji-1f642" role="img" title="smile">:smile:</span></p>



<a name="217766431"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766431" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766431">(Nov 24 2020 at 15:12)</a>:</h4>
<p>but if there's any e-easy issues I'll be happy to look at them</p>



<a name="217766584"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766584" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766584">(Nov 24 2020 at 15:13)</a>:</h4>
<p>I think <a href="https://github.com/rust-lang/rust/issues/70898">https://github.com/rust-lang/rust/issues/70898</a> is the only one tagged as easy that needs work, but there are probably a lot more that just haven't been tagged</p>



<a name="217766709"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766709" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766709">(Nov 24 2020 at 15:14)</a>:</h4>
<p>Feel free to look at any issues tagged T-rustdoc</p>



<a name="217766751"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766751" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766751">(Nov 24 2020 at 15:14)</a>:</h4>
<p>Ok great, I'll do that!</p>



<a name="217766813"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217766813" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217766813">(Nov 24 2020 at 15:14)</a>:</h4>
<p><span class="user-mention silent" data-user-id="344082">Nelson J Morais</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/217766323">said</a>:</p>
<blockquote>
<p>I need to start diving into the code now, to see what that clean::DocContext does.. :)</p>
</blockquote>
<p>consider reading through <a href="https://rustc-dev-guide.rust-lang.org/rustdoc.html">https://rustc-dev-guide.rust-lang.org/rustdoc.html</a> instead, the code is a little hard to follow IMO</p>



<a name="217767921"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217767921" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217767921">(Nov 24 2020 at 15:22)</a>:</h4>
<p>yes I've done it, but that rust doc chapter is not so much detailed like for instance the query system</p>



<a name="217767978"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217767978" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217767978">(Nov 24 2020 at 15:23)</a>:</h4>
<p>but thanks for info!</p>



<a name="217768014"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768014" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768014">(Nov 24 2020 at 15:23)</a>:</h4>
<p>did you see the next page too? <a href="https://rustc-dev-guide.rust-lang.org/rustdoc-internals.html">https://rustc-dev-guide.rust-lang.org/rustdoc-internals.html</a></p>



<a name="217768095"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768095" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768095">(Nov 24 2020 at 15:24)</a>:</h4>
<p>yeah I "heard" somewhere that the rust doc code is becoming hard to maintain <span aria-label="smile" class="emoji emoji-1f642" role="img" title="smile">:smile:</span></p>



<a name="217768126"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768126" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768126">(Nov 24 2020 at 15:24)</a>:</h4>
<p>I don't know if <em>becoming</em> is the right word <span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span></p>



<a name="217768169"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768169" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768169">(Nov 24 2020 at 15:24)</a>:</h4>
<p>it's been like this a while</p>



<a name="217768247"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768247" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768247">(Nov 24 2020 at 15:25)</a>:</h4>
<p>to be honest, not sure about internals.. I think so (am at mobile right now, have the rust-dev-guide open on laptop) either way I'll read it.</p>



<a name="217768320"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768320" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768320">(Nov 24 2020 at 15:25)</a>:</h4>
<p>it has a lot more info than the overview page</p>



<a name="217768371"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768371" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768371">(Nov 24 2020 at 15:26)</a>:</h4>
<p>the main page is the bare minimum 'how do I build rustdoc' bascially</p>



<a name="217768648"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768648" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768648">(Nov 24 2020 at 15:28)</a>:</h4>
<p>will do that.</p>



<a name="217768936"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217768936" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217768936">(Nov 24 2020 at 15:30)</a>:</h4>
<p>altough, definitely will read that "how I build rustdoc" section... most of the inicial pain point will be to find a fast iteration workflow to change, build, test... with fast compilation times</p>



<a name="217769811"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217769811" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217769811">(Nov 24 2020 at 15:36)</a>:</h4>
<p>oh boy XD</p>



<a name="217770113"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217770113" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217770113">(Nov 24 2020 at 15:38)</a>:</h4>
<p>But in any case, if you lack information on something, please ask us so that we can help you and also improve the internal rustdoc book to help other newcomers.</p>



<a name="217773074"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217773074" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217773074">(Nov 24 2020 at 15:57)</a>:</h4>
<p><span class="user-mention silent" data-user-id="210316">GuillaumeGomez</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/217769811">said</a>:</p>
<blockquote>
<p>oh boy XD</p>
</blockquote>
<p>sounds comforting <span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span></p>



<a name="217773182"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217773182" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217773182">(Nov 24 2020 at 15:58)</a>:</h4>
<p>but yeah.. I'll bug you all if  I find roadblocks <span aria-label="smile" class="emoji emoji-1f642" role="img" title="smile">:smile:</span></p>



<a name="217796720"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217796720" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217796720">(Nov 24 2020 at 18:42)</a>:</h4>
<div class="codehilite" data-code-language="Bash"><pre><span></span><code>d:<span class="se">\C</span>ode<span class="se">\r</span>ust<span class="se">\r</span>ust<span class="se">\(</span>patch_rustdoc<span class="o">)</span>&gt; x.py build library/test
Updating only changed submodules
Submodules updated in <span class="m">0</span>.20 seconds
downloading https://static.rust-lang.org/dist/2020-11-18/rust-std-beta-i686-pc-windows-gnu.tar.xz
extracting d:<span class="se">\C</span>ode<span class="se">\r</span>ust<span class="se">\r</span>ust<span class="se">\b</span>uild<span class="se">\c</span>ache<span class="se">\2</span><span class="m">020</span>-11-18<span class="se">\r</span>ust-std-beta-i686-pc-windows-gnu.tar.xz
downloading https://static.rust-lang.org/dist/2020-11-18/rustc-beta-i686-pc-windows-gnu.tar.xz
extracting d:<span class="se">\C</span>ode<span class="se">\r</span>ust<span class="se">\r</span>ust<span class="se">\b</span>uild<span class="se">\c</span>ache<span class="se">\2</span><span class="m">020</span>-11-18<span class="se">\r</span>ustc-beta-i686-pc-windows-gnu.tar.xz
downloading https://static.rust-lang.org/dist/2020-11-18/cargo-beta-i686-pc-windows-gnu.tar.xz
extracting d:<span class="se">\C</span>ode<span class="se">\r</span>ust<span class="se">\r</span>ust<span class="se">\b</span>uild<span class="se">\c</span>ache<span class="se">\2</span><span class="m">020</span>-11-18<span class="se">\c</span>argo-beta-i686-pc-windows-gnu.tar.xz
downloading https://static.rust-lang.org/dist/2020-11-19/rustfmt-nightly-i686-pc-windows-gnu.tar.xz
extracting d:<span class="se">\C</span>ode<span class="se">\r</span>ust<span class="se">\r</span>ust<span class="se">\b</span>uild<span class="se">\c</span>ache<span class="se">\2</span><span class="m">020</span>-11-19<span class="se">\r</span>ustfmt-nightly-i686-pc-windows-gnu.tar.xz
downloading https://ci-artifacts.rust-lang.org/rustc-builds-alt/430feb24a46993e5073c1bb1b39da190d83fa2bf/rust-dev-nightly-i686-pc-windows-gnu.tar.xz
Exception calling <span class="s2">"DownloadFile"</span> with <span class="s2">"2"</span> argument<span class="o">(</span>s<span class="o">)</span>: <span class="s2">"The remote server returned an error: (404) Not Found."</span>
At line:1 char:82
+ ... pe<span class="o">]</span>::Tls12<span class="p">;</span> <span class="o">(</span>New-Object System.Net.WebClient<span class="o">)</span>.DownloadFile<span class="o">(</span><span class="err">'</span>https://c ...
+                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: <span class="o">(</span>:<span class="o">)</span> <span class="o">[]</span>, MethodInvocationException
    + FullyQualifiedErrorId : WebException


spurious failure, trying again
downloading https://ci-artifacts.rust-lang.org/rustc-builds-alt/430feb24a46993e5073c1bb1b39da190d
<span class="sb">`</span>
</code></pre></div>



<a name="217796791"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217796791" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217796791">(Nov 24 2020 at 18:43)</a>:</h4>
<p>is rust-dev-nightly..tar the file that contains llvm artifacts? I suspect we don't build llvm for windows?<br>
(I do have: <code>download-ci-llvm = true</code> in my config.toml)</p>



<a name="217797214"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217797214" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217797214">(Nov 24 2020 at 18:47)</a>:</h4>
<p>You should remove that then</p>



<a name="217797246"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217797246" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217797246">(Nov 24 2020 at 18:47)</a>:</h4>
<p>painfull <span aria-label="frown" class="emoji emoji-1f641" role="img" title="frown">:frown:</span> lol</p>



<a name="217797254"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217797254" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217797254">(Nov 24 2020 at 18:47)</a>:</h4>
<p>Hmm, I think the guide might recommend that - it should recommend if-available instead</p>



<a name="217797296"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217797296" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217797296">(Nov 24 2020 at 18:47)</a>:</h4>
<p>can i point config.toml to use already installed llvm binaries?<br>
any documentation about that ?</p>



<a name="217797302"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217797302" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217797302">(Nov 24 2020 at 18:47)</a>:</h4>
<p>Sure</p>



<a name="217797400"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217797400" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217797400">(Nov 24 2020 at 18:48)</a>:</h4>
<p><a href="https://rustc-dev-guide.rust-lang.org/building/suggested.html#skipping-llvm-build">https://rustc-dev-guide.rust-lang.org/building/suggested.html#skipping-llvm-build</a></p>



<a name="217797419"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217797419" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217797419">(Nov 24 2020 at 18:48)</a>:</h4>
<div class="codehilite" data-code-language="Bash"><pre><span></span><code>d:<span class="se">\C</span>ode<span class="se">\r</span>ust&gt; ls <span class="s2">"c:\Program Files\LLVM\"</span>
<span class="s2">───┬─────────────────────────────────────┬──────┬──────────┬──────────────</span>
<span class="s2"> # │ name                                │ type │ size     │ modified</span>
<span class="s2">───┼─────────────────────────────────────┼──────┼──────────┼──────────────</span>
<span class="s2"> 0 │ c:\Program Files\LLVM\Uninstall.exe │ File │ 158.2 KB │ 6 months ago</span>
<span class="s2"> 1 │ c:\Program Files\LLVM\bin           │ Dir  │  49.2 KB │ 6 months ago</span>
<span class="s2"> 2 │ c:\Program Files\LLVM\include       │ Dir  │      0 B │ 6 months ago</span>
<span class="s2"> 3 │ c:\Program Files\LLVM\lib           │ Dir  │   4.1 KB │ 6 months ago</span>
<span class="s2"> 4 │ c:\Program Files\LLVM\libexec       │ Dir  │   4.1 KB │ 6 months ago</span>
<span class="s2"> 5 │ c:\Program Files\LLVM\share         │ Dir  │   4.1 KB │ 6 months ago</span>
<span class="s2">───┴─────────────────────────────────────┴──────┴──────────┴──────────────</span>
</code></pre></div>
<p>I think I'll try that first...</p>



<a name="217797456"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217797456" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217797456">(Nov 24 2020 at 18:49)</a>:</h4>
<p>thanks for the link Joshua! <span aria-label="+1" class="emoji emoji-1f44d" role="img" title="+1">:+1:</span></p>



<a name="217804999"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217804999" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217804999">(Nov 24 2020 at 19:51)</a>:</h4>
<p>I usually just run "./x.py test src/test/rustdoc"</p>



<a name="217805359"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217805359" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217805359">(Nov 24 2020 at 19:54)</a>:</h4>
<div class="codehilite" data-code-language="Bash"><pre><span></span><code>   Compiling <span class="nb">test</span> v0.0.0 <span class="o">(</span>D:<span class="se">\C</span>ode<span class="se">\r</span>ust<span class="se">\r</span>ust<span class="se">\l</span>ibrary<span class="se">\t</span>est<span class="o">)</span>
    Finished release <span class="o">[</span>optimized + debuginfo<span class="o">]</span> target<span class="o">(</span>s<span class="o">)</span> in 1m 36s
Copying stage1 std from stage1 <span class="o">(</span>x86_64-pc-windows-msvc -&gt; x86_64-pc-windows-msvc / x86_64-pc-windows-msvc<span class="o">)</span>
Build completed successfully in <span class="m">0</span>:41:16
</code></pre></div>
<p><span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span></p>



<a name="217805400"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217805400" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217805400">(Nov 24 2020 at 19:55)</a>:</h4>
<p>yep, first time is awfully slow</p>



<a name="217805434"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217805434" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217805434">(Nov 24 2020 at 19:55)</a>:</h4>
<p>and with llvm it's even worse</p>



<a name="217806176"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217806176" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217806176">(Nov 24 2020 at 20:02)</a>:</h4>
<p>yeah...</p>



<a name="217808810"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217808810" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217808810">(Nov 24 2020 at 20:24)</a>:</h4>
<div class="codehilite" data-code-language="Rust"><pre><span></span><code><span class="w">    </span><span class="c1">// need to move these items separately because we lose them by the time the closure is called,</span>
<span class="w">    </span><span class="c1">// but we can't crates the Handler ahead of time because it's not Send</span>
<span class="w">    </span><span class="kd">let</span><span class="w"> </span><span class="n">diag_opts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="n">options</span><span class="p">.</span><span class="n">error_format</span><span class="p">,</span><span class="w"> </span><span class="n">options</span><span class="p">.</span><span class="n">edition</span><span class="p">,</span><span class="w"> </span><span class="n">options</span><span class="p">.</span><span class="n">debugging_opts</span><span class="p">.</span><span class="n">clone</span><span class="p">());</span><span class="w"></span>
<span class="w">    </span><span class="kd">let</span><span class="w"> </span><span class="n">show_coverage</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">options</span><span class="p">.</span><span class="n">show_coverage</span><span class="p">;</span><span class="w"></span>
<span class="w">    </span><span class="kd">let</span><span class="w"> </span><span class="n">run_check</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">options</span><span class="p">.</span><span class="n">run_check</span><span class="p">;</span><span class="w"></span>

<span class="w">    </span><span class="c1">// First, parse the crate and extract all relevant information.</span>
<span class="w">    </span><span class="n">info</span><span class="o">!</span><span class="p">(</span><span class="s">"starting to run rustc"</span><span class="p">);</span><span class="w"></span>
</code></pre></div>
<p>isn't crates in "but we can't crates the Handler ahead of time because it's not Send" a typo in <code>src/librustdoc/lib.rs:516</code>?<br>
(we could see it as a funny way to write creates..lol)</p>



<a name="217816456"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217816456" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217816456">(Nov 24 2020 at 21:33)</a>:</h4>
<p>haha, yeah that should be <code>create</code></p>



<a name="217816474"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217816474" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217816474">(Nov 24 2020 at 21:33)</a>:</h4>
<p><span class="user-mention" data-user-id="344082">@Nelson J Morais</span> want to make that your first PR? :)</p>



<a name="217829842"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217829842" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217829842">(Nov 24 2020 at 23:58)</a>:</h4>
<p>Yes! Finally, a Zulip stream.</p>



<a name="217832429"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217832429" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217832429">(Nov 25 2020 at 00:33)</a>:</h4>
<p>Damn it. It's now like rolling snow ball on a damn snowy slope T_T</p>



<a name="217832474"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217832474" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217832474">(Nov 25 2020 at 00:34)</a>:</h4>
<p><span class="user-mention" data-user-id="232545">@Joshua Nelson</span> You tricked me efficiently there! Well done I guess XD</p>



<a name="217905963"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217905963" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217905963">(Nov 25 2020 at 16:18)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/217816474">said</a>:</p>
<blockquote>
<p><span class="user-mention silent" data-user-id="344082">Nelson J Morais</span> want to make that your first PR? <span aria-label="smile" class="emoji emoji-1f642" role="img" title="smile">:smile:</span></p>
</blockquote>
<p>sure will do that later today, to celebrate the new contribution and the <code>rustdoc</code> stream here at zulip <span aria-label="smile" class="emoji emoji-1f642" role="img" title="smile">:smile:</span></p>



<a name="217927872"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217927872" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217927872">(Nov 25 2020 at 19:22)</a>:</h4>
<p>PR <a href="https://github.com/rust-lang/rust/pull/79420">https://github.com/rust-lang/rust/pull/79420</a></p>



<a name="217997026"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217997026" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217997026">(Nov 26 2020 at 12:43)</a>:</h4>
<p><span class="user-mention" data-user-id="232545">@Joshua Nelson</span> <span class="user-mention" data-user-id="210316">@GuillaumeGomez</span> a first _early_ draft of the recruiting blog post is available on hackmd. Shared it with Johua. Guillaume, are you also on hackmd? Otherwise I will send you the doc</p>



<a name="217997300"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/217997300" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#217997300">(Nov 26 2020 at 12:46)</a>:</h4>
<p>I think I am, but please send me the link directly because I'll never find my name. ^^'</p>



<a name="218004510"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218004510" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218004510">(Nov 26 2020 at 13:59)</a>:</h4>
<p><span class="user-mention" data-user-id="250987">@apiraino</span> you said  needs to be updated, but it is up to date - everyone listed on <a href="https://www.rust-lang.org/governance/teams/dev-tools#rustdoc">https://www.rust-lang.org/governance/teams/dev-tools#rustdoc</a> is part of the team</p>



<a name="218004747"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218004747" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218004747">(Nov 26 2020 at 14:01)</a>:</h4>
<p><span class="user-mention" data-user-id="250987">@apiraino</span> where did you get the link to <a href="https://readrust.net/support">https://readrust.net/support</a> ? you're right, that one's definitely out of date <span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span></p>



<a name="218004825"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218004825" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218004825">(Nov 26 2020 at 14:02)</a>:</h4>
<p>I think I've searched "rustdoc team" or something like that on ddg :)</p>



<a name="218004864"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218004864" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218004864">(Nov 26 2020 at 14:02)</a>:</h4>
<p>oof, the top hit for that for me is <a href="https://www.rust-lang.org/governance/teams/documentation">https://www.rust-lang.org/governance/teams/documentation</a> <span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span></p>



<a name="218004904"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218004904" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218004904">(Nov 26 2020 at 14:03)</a>:</h4>
<p><span class="user-mention" data-user-id="116011">@Steve Klabnik</span> the documentation team doesn't really exist anymore, right? Should we take down that page from RLO?</p>



<a name="218004986"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218004986" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Steve Klabnik <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218004986">(Nov 26 2020 at 14:03)</a>:</h4>
<p>So yeah I have a PR to do that but they wanted an adjustment and I keep forgetting to finish it <span aria-label="frown" class="emoji emoji-1f641" role="img" title="frown">:frown:</span></p>



<a name="218004987"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218004987" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218004987">(Nov 26 2020 at 14:03)</a>:</h4>
<p>also google seems to be very confused about the difference between <code>rust docs</code> and <code>rustdoc</code></p>



<a name="218005055"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005055" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Steve Klabnik <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005055">(Nov 26 2020 at 14:04)</a>:</h4>
<p>So yes we should. If anyone wants to fix it for me go ahead.</p>



<a name="218005078"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005078" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005078">(Nov 26 2020 at 14:04)</a>:</h4>
<p>is that <a href="https://github.com/rust-lang/team/pull/298">https://github.com/rust-lang/team/pull/298</a> ?</p>



<a name="218005082"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005082" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Steve Klabnik <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005082">(Nov 26 2020 at 14:04)</a>:</h4>
<p>But I will try to at some point soon. It’s not hard, just... life is hard Hackett</p>



<a name="218005095"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005095" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Steve Klabnik <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005095">(Nov 26 2020 at 14:04)</a>:</h4>
<p>Lately (ugh phones and autocorrect)</p>



<a name="218005185"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005185" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005185">(Nov 26 2020 at 14:05)</a>:</h4>
<p>no problem at all <span aria-label="heart" class="emoji emoji-2764" role="img" title="heart">:heart:</span> I know this year has been crazy</p>



<a name="218005334"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005334" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005334">(Nov 26 2020 at 14:06)</a>:</h4>
<p><span class="user-mention" data-user-id="250987">@apiraino</span> I noticed you linked to issues with <code>A-doctests</code> - was that intentional? I was planning to link to <code>T-rustdoc</code> instead</p>



<a name="218005407"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005407" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005407">(Nov 26 2020 at 14:07)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218005334">said</a>:</p>
<blockquote>
<p><span class="user-mention silent" data-user-id="250987">apiraino</span> I noticed you linked to issues with <code>A-doctests</code> - was that intentional? I was planning to link to <code>T-rustdoc</code> instead</p>
</blockquote>
<p>please update the list of issues you would like to have prominent <span aria-label="thumbs up" class="emoji emoji-1f44d" role="img" title="thumbs up">:thumbs_up:</span> I've just picked a random filter</p>



<a name="218005540"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005540" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005540">(Nov 26 2020 at 14:08)</a>:</h4>
<blockquote>
<p>We also welcome very much feedback about rustdoc, that’s another form of contribution that can help us get a drift of how people use rustdoc, what they like and how we can improve.</p>
</blockquote>
<p>so, this is a bit of a sore point for me - feedback is definitely useful and welcome, but we have so much feedback in backlog I don't know if it's actually helpful to ask for more</p>



<a name="218005825"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005825" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005825">(Nov 26 2020 at 14:10)</a>:</h4>
<p>and by 'feedback in backlog' I mean things like </p>
<ul>
<li><a href="https://github.com/rust-lang/rust/issues/20962">https://github.com/rust-lang/rust/issues/20962</a></li>
<li><a href="https://github.com/rust-lang/rust/issues/32104">https://github.com/rust-lang/rust/issues/32104</a></li>
<li><a href="https://github.com/rust-lang/rust/issues/31387">https://github.com/rust-lang/rust/issues/31387</a></li>
<li><a href="https://github.com/rust-lang/rust/issues/36722">https://github.com/rust-lang/rust/issues/36722</a></li>
<li><a href="https://github.com/rust-lang/rust/issues/43571">https://github.com/rust-lang/rust/issues/43571</a></li>
<li><a href="https://github.com/rust-lang/rust/issues/48935">https://github.com/rust-lang/rust/issues/48935</a></li>
</ul>



<a name="218005834"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005834" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005834">(Nov 26 2020 at 14:10)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218005540">said</a>:</p>
<blockquote>
<blockquote>
<p>We also welcome very much feedback about rustdoc, that’s another form of contribution that can help us get a drift of how people use rustdoc, what they like and how we can improve.</p>
</blockquote>
<p>so, this is a bit of a sore point for me - feedback is definitely useful and welcome, but we have so much feedback in backlog I don't know if it's actually helpful to ask for more</p>
</blockquote>
<p>that's ok, please delete that if it doesn't match the reality. Like I said, I need the rustdoc team to validate this braindump :-) I just wanted to get things started</p>



<a name="218005890"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005890" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005890">(Nov 26 2020 at 14:11)</a>:</h4>
<p>like, there are definitely giant issues but when I look at them I feel a little overwhelmed <span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span> so I'm not sure if asking for even more issues is helpful right now</p>



<a name="218005948"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218005948" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218005948">(Nov 26 2020 at 14:11)</a>:</h4>
<p>I've linked the blog post from Guillaume because in 2020 he specifically asked for feedback. I guess you have now more than enough :D</p>



<a name="218006049"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218006049" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218006049">(Nov 26 2020 at 14:12)</a>:</h4>
<p>oh lets loop in <span class="user-mention" data-user-id="210316">@GuillaumeGomez</span></p>



<a name="218006057"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218006057" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218006057">(Nov 26 2020 at 14:12)</a>:</h4>
<p>I hadn't read his post</p>



<a name="218006835"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218006835" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218006835">(Nov 26 2020 at 14:19)</a>:</h4>
<p>the <code>TODO</code>s I left are just side thoughts that came up while drafting the post:  just questions to you team and they can be easily answered or removed</p>



<a name="218007360"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007360" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007360">(Nov 26 2020 at 14:24)</a>:</h4>
<p><span class="user-mention" data-user-id="250987">@apiraino</span> although I do think rustdoc's code is hard to follow, I'm not sure we want to put that front and center on the blog post <span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span> I'm a little worried we're scaring people off with all the caveats about the difficulty</p>



<a name="218007378"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007378" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007378">(Nov 26 2020 at 14:24)</a>:</h4>
<p>maybe it makes sense to wait until after we move rustdoc out of tree to make the post?</p>



<a name="218007439"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007439" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007439">(Nov 26 2020 at 14:25)</a>:</h4>
<p>I don't know anyone that's on IRC. I'm curious why you say discord is confusing? (Zulip is understandable)</p>



<a name="218007466"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007466" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007466">(Nov 26 2020 at 14:25)</a>:</h4>
<p>and we should probably ask <span class="user-mention" data-user-id="210316">@GuillaumeGomez</span> whether to suggest the discord or the zulip</p>



<a name="218007601"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007601" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007601">(Nov 26 2020 at 14:27)</a>:</h4>
<blockquote>
<p>although I do think rustdoc's code is hard to follow, I'm not sure we want to put that front and center on the blog post <span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span> I'm a little worried we're scaring people off with all the caveats about the difficulty</p>
</blockquote>
<p>makes sense. On the other end I think it would be fair to set the expectations clear about contributing to the project, but please set the general "tone" of the blog post to your liking :-)</p>



<a name="218007714"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007714" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007714">(Nov 26 2020 at 14:28)</a>:</h4>
<p>well, I don't think it's any harder than working on the rest of the compiler</p>



<a name="218007725"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007725" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007725">(Nov 26 2020 at 14:28)</a>:</h4>
<p>the bar is just a lot higher than, say, clippy</p>



<a name="218007759"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007759" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007759">(Nov 26 2020 at 14:29)</a>:</h4>
<p><span aria-label="eyes" class="emoji emoji-1f440" role="img" title="eyes">:eyes:</span></p>



<a name="218007886"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007886" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007886">(Nov 26 2020 at 14:30)</a>:</h4>
<blockquote>
<p>I don't know anyone that's on IRC. I'm curious why you say discord is confusing? (Zulip is understandable)</p>
</blockquote>
<p>what I meant (and probably failed to convey) is that people would want to know whether they should get in touch on Zulip <strong>or</strong> on Discord. I'm afraid that managing the team efforts on both platforms would be an organizational burden for you. As far as I know most teams or WG are on zulip <em>or</em> discord</p>



<a name="218007904"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007904" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007904">(Nov 26 2020 at 14:30)</a>:</h4>
<p>I really don't like zulip but more and more teams seem to be switching to it... But for now, we can maybe mention both and maybe wait to have new members to get their opinion on this topic?</p>



<a name="218007976"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007976" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007976">(Nov 26 2020 at 14:31)</a>:</h4>
<p>I would prefer to decide on this <em>before</em> we invite more people</p>



<a name="218007981"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007981" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007981">(Nov 26 2020 at 14:31)</a>:</h4>
<p>I think you should be clear on where to onboard and manage people before. otherwise then you have to move people around</p>



<a name="218007982"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007982" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007982">(Nov 26 2020 at 14:31)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218007439">said</a>:</p>
<blockquote>
<p>I don't know anyone that's on IRC. I'm curious why you say discord is confusing? (Zulip is understandable)</p>
</blockquote>
<p>Most of my interactions for development are on IRC XD</p>



<a name="218007983"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218007983" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218007983">(Nov 26 2020 at 14:31)</a>:</h4>
<p>otherwise it's confusing</p>



<a name="218008003"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218008003" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218008003">(Nov 26 2020 at 14:31)</a>:</h4>
<p><span class="user-mention silent" data-user-id="210316">GuillaumeGomez</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218007982">said</a>:</p>
<blockquote>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218007439">said</a>:</p>
<blockquote>
<p>I don't know anyone that's on IRC. I'm curious why you say discord is confusing? (Zulip is understandable)</p>
</blockquote>
<p>Most of my interactions for development are on IRC XD</p>
</blockquote>
<p>well, I meant specifically for rustdoc</p>



<a name="218008070"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218008070" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218008070">(Nov 26 2020 at 14:32)</a>:</h4>
<p>The problem is that we're the only two active members. I prefer discord, you prefer zulip. On that stand, I don't want to force anything</p>



<a name="218008159"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218008159" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218008159">(Nov 26 2020 at 14:33)</a>:</h4>
<p>/me smiles at the joy of platform choice</p>



<a name="218008266"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218008266" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218008266">(Nov 26 2020 at 14:34)</a>:</h4>
<p>Well, the big problem remains that we don't have an official "Rust teams hub", so that's not great :-/</p>



<a name="218008348"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218008348" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218008348">(Nov 26 2020 at 14:35)</a>:</h4>
<p>to be fair, the official rust lang website mentions Discord<br>
<a href="https://www.rust-lang.org/governance/teams/dev-tools#rustdoc">https://www.rust-lang.org/governance/teams/dev-tools#rustdoc</a></p>



<a name="218008938"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218008938" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218008938">(Nov 26 2020 at 14:41)</a>:</h4>
<p>Yep :p</p>



<a name="218008967"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218008967" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218008967">(Nov 26 2020 at 14:41)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218007378">said</a>:</p>
<blockquote>
<p>maybe it makes sense to wait until after we move rustdoc out of tree to make the post?</p>
</blockquote>
<p><span class="user-mention" data-user-id="210316">@GuillaumeGomez</span> <span aria-label="point up" class="emoji emoji-1f446" role="img" title="point up">:point_up:</span> </p>
<p>up to you to decide depending on how mentoring newcomers would better work out. I don't know the timeline for moving rustdoc out of tree but I wouldn't want to make it a blocker for (say) 4~6 months.</p>



<a name="218009031"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218009031" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218009031">(Nov 26 2020 at 14:42)</a>:</h4>
<p>I think I'll have time to work on it over winter break if <span class="user-mention" data-user-id="210316">@GuillaumeGomez</span> is ok with it</p>



<a name="218010242"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218010242" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218010242">(Nov 26 2020 at 14:54)</a>:</h4>
<p>tl;dr of <a href="#narrow/stream/266220-rustdoc/topic/Building.20rustdoc.20out.20of.20tree">https://rust-lang.zulipchat.com/#narrow/stream/266220-rustdoc/topic/Building.20rustdoc.20out.20of.20tree</a>: it's probably not happening in the near future, so we should publish the blog post first</p>



<a name="218011667"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218011667" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218011667">(Nov 26 2020 at 15:06)</a>:</h4>
<p>However on that topic: isn't it possible to specify a rustc binary in the <code>config.toml</code>? So would already partially solve our issue no?</p>



<a name="218011741"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218011741" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218011741">(Nov 26 2020 at 15:07)</a>:</h4>
<p>Like that, for newcomers who don't care about the compiler, they can just add this line and in 5 minutes they have a built rustdoc and std doc</p>



<a name="218012661"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218012661" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218012661">(Nov 26 2020 at 15:15)</a>:</h4>
<p>oh hmm, use <code>rustup-toolchain-install-master</code> but in-tree</p>



<a name="218012669"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218012669" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218012669">(Nov 26 2020 at 15:15)</a>:</h4>
<p>that's an interesting idea</p>



<a name="218012675"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218012675" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218012675">(Nov 26 2020 at 15:15)</a>:</h4>
<p><span class="user-mention" data-user-id="132040">@Manish Goregaokar</span> what do you think?</p>



<a name="218016558"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218016558" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218016558">(Nov 26 2020 at 15:55)</a>:</h4>
<p>At least it would allow to have it already so we can take our time talking about moving out-of-tree. And it brings advantages: you can disable it if you need to update something in the compiler, no need to update the compiler version repeatedly. :)</p>



<a name="218017238"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218017238" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218017238">(Nov 26 2020 at 16:01)</a>:</h4>
<p>right, yeah I really like the flexibility that brings</p>



<a name="218017900"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218017900" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218017900">(Nov 26 2020 at 16:08)</a>:</h4>
<p><span class="user-mention silent" data-user-id="344082">Nelson J Morais</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/217768936">said</a>:</p>
<blockquote>
<p>altough, definitely will read that "how I build rustdoc" section... most of the inicial pain point will be to find a fast iteration workflow to change, build, test... with fast compilation times</p>
</blockquote>
<p>that might help in my quest to find that fast iteration workflow ^</p>



<a name="218018080"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218018080" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218018080">(Nov 26 2020 at 16:10)</a>:</h4>
<p><span class="user-mention" data-user-id="344082">@Nelson J Morais</span> do you want to test it out? there are some ideas in <a href="https://github.com/rust-lang/rust/issues/66581">https://github.com/rust-lang/rust/issues/66581</a> :)</p>



<a name="218018546"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218018546" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218018546">(Nov 26 2020 at 16:15)</a>:</h4>
<p><span aria-label="+1" class="emoji emoji-1f44d" role="img" title="+1">:+1:</span> , but firstly I'll look into that issue  <a href="https://github.com/rust-lang/rust/issues/70898">https://github.com/rust-lang/rust/issues/70898</a> that you've posted yesterday...apparently is just documentation</p>



<a name="218027275"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218027275" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218027275">(Nov 26 2020 at 18:04)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218007976">said</a>:</p>
<blockquote>
<p>I would prefer to decide on this <em>before</em> we invite more people</p>
</blockquote>
<p>strong agree</p>



<a name="218027325"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218027325" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218027325">(Nov 26 2020 at 18:05)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218012675">said</a>:</p>
<blockquote>
<p><span class="user-mention silent" data-user-id="132040">Manish Goregaokar</span> what do you think?</p>
</blockquote>
<p>I think this can work and it's a prerequisite to making rustdoc work out of tree anyway. You'll need to get the tests to run though,</p>



<a name="218031128"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218031128" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Poliorcetics <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218031128">(Nov 26 2020 at 19:02)</a>:</h4>
<p>Hello ! I would very much like to contribute to rustdoc (and get back to contributing to std) but I’m not sure if I’ll consistently find time each week, is there something easy I can start with ?</p>



<a name="218031155"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218031155" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218031155">(Nov 26 2020 at 19:03)</a>:</h4>
<p>hmm, this is actually one of the things we need help with, going through the issues and finding which are hard and which are easy</p>



<a name="218031224"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218031224" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218031224">(Nov 26 2020 at 19:04)</a>:</h4>
<p>if you want to look at <em>all</em> issues, there's a list here: <a href="https://github.com/rust-lang/rust/labels/T-rustdoc">https://github.com/rust-lang/rust/labels/T-rustdoc</a></p>



<a name="218031240"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218031240" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218031240">(Nov 26 2020 at 19:04)</a>:</h4>
<p>unfortunately most of the mentored issues have already been claimed <a href="https://github.com/rust-lang/rust/issues?q=is%3Aopen+label%3AT-rustdoc+label%3AE-mentor">https://github.com/rust-lang/rust/issues?q=is%3Aopen+label%3AT-rustdoc+label%3AE-mentor</a></p>



<a name="218033105"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218033105" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218033105">(Nov 26 2020 at 19:32)</a>:</h4>
<p><span class="user-mention silent" data-user-id="132040">Manish Goregaokar</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218027325">said</a>:</p>
<blockquote>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218012675">said</a>:</p>
<blockquote>
<p><span class="user-mention silent" data-user-id="132040">Manish Goregaokar</span> what do you think?</p>
</blockquote>
<p>I think this can work and it's a prerequisite to making rustdoc work out of tree anyway. You'll need to get the tests to run though,</p>
</blockquote>
<p>What's the big deal about the out of tree btw? I thought it was mostly about the compile-time but it seems that I misunderstood it completely. :-/</p>



<a name="218033163"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218033163" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218033163">(Nov 26 2020 at 19:33)</a>:</h4>
<p>I mostly wanted it for compile times</p>



<a name="218033215"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218033215" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218033215">(Nov 26 2020 at 19:34)</a>:</h4>
<p>I'm not sure why <span class="user-mention" data-user-id="132040">@Manish Goregaokar</span> wanted rustdoc to be usable out-of-tree</p>



<a name="218034650"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218034650" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218034650">(Nov 26 2020 at 20:00)</a>:</h4>
<p>because it's a real pain and a bad onboarding experience</p>



<a name="218034655"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218034655" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218034655">(Nov 26 2020 at 20:00)</a>:</h4>
<p>people aren't used to the rustc build system</p>



<a name="218034669"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218034669" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218034669">(Nov 26 2020 at 20:01)</a>:</h4>
<p>compile time is a part of it but people need to mess with stages, etc</p>



<a name="218034677"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218034677" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218034677">(Nov 26 2020 at 20:01)</a>:</h4>
<p>with clippy it's just cargo test</p>



<a name="218034682"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218034682" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218034682">(Nov 26 2020 at 20:01)</a>:</h4>
<p>and this is a huge part why clippy is easy to contribute to</p>



<a name="218035107"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218035107" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218035107">(Nov 26 2020 at 20:09)</a>:</h4>
<p>ah ok, that makes sense</p>



<a name="218035120"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218035120" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218035120">(Nov 26 2020 at 20:09)</a>:</h4>
<p>yeah having  <code>cargo test</code>  'just work' would be really nice</p>



<a name="218036410"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036410" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036410">(Nov 26 2020 at 20:33)</a>:</h4>
<p><span class="user-mention silent" data-user-id="132040">Manish Goregaokar</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218034677">said</a>:</p>
<blockquote>
<p>with clippy it's just cargo test</p>
</blockquote>
<p>With cargo too and yet you don't see huge contributions. I don't think this is where most of the newcomers difficulty is to be honest.</p>



<a name="218036780"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036780" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036780">(Nov 26 2020 at 20:39)</a>:</h4>
<p>Heh, I actually find <em>rustdoc</em> easier to contribute to.</p>



<a name="218036834"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036834" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036834">(Nov 26 2020 at 20:40)</a>:</h4>
<p>oh? why's that?</p>



<a name="218036855"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036855" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036855">(Nov 26 2020 at 20:40)</a>:</h4>
<p>All I do is run <code>./x.py build</code> and <code>./x.py test src/test/rustdoc --bless</code> and it handles everything for me</p>



<a name="218036866"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036866" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036866">(Nov 26 2020 at 20:41)</a>:</h4>
<p>With Clippy, you can run <code>cargo build</code> and <code>cargo test</code>, but you also have to run another script to bless tests</p>



<a name="218036879"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036879" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036879">(Nov 26 2020 at 20:41)</a>:</h4>
<p>But I think perhaps the biggest thing is that the subtree situation kind of confuses me</p>



<a name="218036887"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036887" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036887">(Nov 26 2020 at 20:41)</a>:</h4>
<p>It's nice to be able to have everything in one repo</p>



<a name="218036954"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036954" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036954">(Nov 26 2020 at 20:42)</a>:</h4>
<p>I find having one, dedicated script to be easier, rather than several different things</p>



<a name="218036959"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036959" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036959">(Nov 26 2020 at 20:42)</a>:</h4>
<p>I appreciate that too. It makes links between components easier. But I understand that some might disagree</p>



<a name="218036963"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036963" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036963">(Nov 26 2020 at 20:42)</a>:</h4>
<p>But perhaps I'm just used to <code>x.py</code> and not used to Clippy's system, and that's why</p>



<a name="218036986"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218036986" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218036986">(Nov 26 2020 at 20:43)</a>:</h4>
<p>And to be honest, with the recent merge of gtk-rs, I'm more in favor of single repositories, it made things much simpler.</p>



<a name="218037114"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037114" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037114">(Nov 26 2020 at 20:45)</a>:</h4>
<p><em>The joy of the monorepo</em> :)</p>



<a name="218037299"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037299" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037299">(Nov 26 2020 at 20:48)</a>:</h4>
<p>I had better experience with monorepo overall haha</p>



<a name="218037329"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037329" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037329">(Nov 26 2020 at 20:49)</a>:</h4>
<p>I didn't even realize there were plans to make a separate repo for rustdoc. Can you point me to the discussion?</p>



<a name="218037417"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037417" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037417">(Nov 26 2020 at 20:50)</a>:</h4>
<p>see vaguely around <a href="#narrow/stream/122651-general/topic/broken.20rust.20docs.20links">https://rust-lang.zulipchat.com/#narrow/stream/122651-general/topic/broken.20rust.20docs.20links</a></p>



<a name="218037436"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037436" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037436">(Nov 26 2020 at 20:51)</a>:</h4>
<p>and <a href="https://discord.com/channels/442252698964721669/459149231702278154/773488567602249768">https://discord.com/channels/442252698964721669/459149231702278154/773488567602249768</a></p>



<a name="218037508"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037508" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037508">(Nov 26 2020 at 20:52)</a>:</h4>
<p>Well I guess if it would mean I wouldn't have to rebuild rustc as much, I would feel better about moving into a separate repo. As long as it's still easy to change rustdoc from rust-lang/rust in case compiler changes are needed.</p>



<a name="218037516"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037516" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Poliorcetics <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037516">(Nov 26 2020 at 20:52)</a>:</h4>
<p>The main complaint on <code>rustdoc</code> being in-tree is that <code>./x.py build</code> is very long the first time, which, for new contributors, is not very engaging (+ they have to discover <code>./x.py</code> too, which can be long and lead to horrible compile times if mishandled)</p>



<a name="218037524"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037524" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037524">(Nov 26 2020 at 20:52)</a>:</h4>
<p>But also it might be annoying if you are working on a PR and then realize you need to change the compiler and have to reapply your work on top of rust-lang/rust</p>



<a name="218037542"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037542" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037542">(Nov 26 2020 at 20:53)</a>:</h4>
<p>At this point, <code>x.py</code> should be pretty easy for basic rustdoc things though. All you do is <code>./x.py build</code> and <code>./x.py test src/test/rustdoc</code></p>



<a name="218037554"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037554" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037554">(Nov 26 2020 at 20:53)</a>:</h4>
<p>As long as we don't have any of that <code>./x.py build --stage 1 --keep-stage 0</code> advice left</p>



<a name="218037606"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037606" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037606">(Nov 26 2020 at 20:54)</a>:</h4>
<p>(Oh, I'm so glad we can finally talk on Zulip <span aria-label="pray" class="emoji emoji-1f64f" role="img" title="pray">:pray:</span>)</p>



<a name="218037612"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037612" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Poliorcetics <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037612">(Nov 26 2020 at 20:54)</a>:</h4>
<p><span class="user-mention silent" data-user-id="307537">Camelid</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218037542">said</a>:</p>
<blockquote>
<p>At this point, <code>x.py</code> should be pretty easy for basic rustdoc things though. All you do is <code>./x.py build</code> and <code>./x.py test src/test/rustdoc</code></p>
</blockquote>
<p>That has to be discovered and the first <code>./x.py build</code> is lonngggggg (especially for people without CI-llvm)</p>



<a name="218037630"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037630" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Poliorcetics <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037630">(Nov 26 2020 at 20:54)</a>:</h4>
<p>After that though, the experience is quite nice IMO</p>



<a name="218037834"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037834" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037834">(Nov 26 2020 at 20:58)</a>:</h4>
<p>So it sounds like we should try rustup-toolchain-install-master in-tree and see how that goes</p>



<a name="218037856"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037856" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037856">(Nov 26 2020 at 20:59)</a>:</h4>
<p>And then we can separate the awful compile times from building in-tree vs out of tree</p>



<a name="218037977"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218037977" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218037977">(Nov 26 2020 at 21:00)</a>:</h4>
<p>The only issue I see is there will be two different ways to build rustdoc now: one with x.py and one with a recent nightly; we need a way to teach it</p>



<a name="218038175"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218038175" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Poliorcetics <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218038175">(Nov 26 2020 at 21:03)</a>:</h4>
<p>Is there a precedent for a <code>./x.py rustdoc</code> command that would call <code>rustup-toolchain-install-master</code> ?</p>



<a name="218038198"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218038198" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Poliorcetics <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218038198">(Nov 26 2020 at 21:04)</a>:</h4>
<p>That way people can still use <code>x.py</code> without having to worry about 2 build systems</p>



<a name="218039288"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218039288" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218039288">(Nov 26 2020 at 21:21)</a>:</h4>
<p>Well that's still two different build systems, they're just using the same command</p>



<a name="218039299"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218039299" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218039299">(Nov 26 2020 at 21:21)</a>:</h4>
<p>And they fundamentally need to be different build systems or you won't be able to make changes to rustc and rustdoc at the same time</p>



<a name="218044373"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218044373" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218044373">(Nov 26 2020 at 23:11)</a>:</h4>
<p>One of the things that I find frustrating about subtrees is cases like <a href="https://github.com/rust-lang/rust/issues/79329">#79329</a>. I need to update Clippy test output, but running <code>./x.py test</code> isn't giving me enough information, so I tried <code>cd</code>'ing into <code>src/tools/clippy</code> and running <code>cargo test</code>, but now I'm getting an unrelated compile error (and I have no idea what's causing it):</p>
<div class="codehilite"><pre><span></span><code>error[E0599]: no method named `def_id` found for struct `ConstnessAnd&lt;Binder&lt;rustc_middle::ty::TraitRef&lt;&#39;_&gt;&gt;&gt;` in the current scope
  --&gt; src/tools/clippy/clippy_lints/src/future_not_send.rs:71:39
   |
71 |                     if Some(trait_ref.def_id()) == cx.tcx.lang_items().future_trait() {
   |                                       ^^^^^^ method not found in `ConstnessAnd&lt;Binder&lt;rustc_middle::ty::TraitRef&lt;&#39;_&gt;&gt;&gt;`
</code></pre></div>



<a name="218045502"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218045502" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218045502">(Nov 26 2020 at 23:39)</a>:</h4>
<p><span class="user-mention silent" data-user-id="210316">GuillaumeGomez</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218036410">said</a>:</p>
<blockquote>
<p><span class="user-mention silent" data-user-id="132040">Manish Goregaokar</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218034677">said</a>:</p>
<blockquote>
<p>with clippy it's just cargo test</p>
</blockquote>
<p>With cargo too and yet you don't see huge contributions. I don't think this is where most of the newcomers difficulty is to be honest.</p>
</blockquote>
<p>this is because cargo is a tricky codebase to contribute to</p>



<a name="218045526"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218045526" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218045526">(Nov 26 2020 at 23:40)</a>:</h4>
<p>rustdoc is not that complex, but having to do a full rust build and use the rustc build system are problems</p>



<a name="218045553"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218045553" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218045553">(Nov 26 2020 at 23:40)</a>:</h4>
<p>the main thing would be to make it easy to contribute with a preexisting rust</p>



<a name="218045574"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218045574" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218045574">(Nov 26 2020 at 23:41)</a>:</h4>
<p><span class="user-mention silent" data-user-id="307537">Camelid</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218044373">said</a>:</p>
<blockquote>
<p>One of the things that I find frustrating about subtrees is cases like <a href="https://github.com/rust-lang/rust/issues/79329">#79329</a>. I need to update Clippy test output, but running <code>./x.py test</code> isn't giving me enough information, so I tried <code>cd</code>'ing into <code>src/tools/clippy</code> and running <code>cargo test</code>, but now I'm getting an unrelated compile error (and I have no idea what's causing it):</p>
<p><div class="codehilite"><pre><span></span><code>error[E0599]: no method named `def_id` found for struct `ConstnessAnd&lt;Binder&lt;rustc_middle::ty::TraitRef&lt;&#39;_&gt;&gt;&gt;` in the current scope
  --&gt; src/tools/clippy/clippy_lints/src/future_not_send.rs:71:39
   |
71 |                     if Some(trait_ref.def_id()) == cx.tcx.lang_items().future_trait() {
   |                                       ^^^^^^ method not found in `ConstnessAnd&lt;Binder&lt;rustc_middle::ty::TraitRef&lt;&#39;_&gt;&gt;&gt;`
</code></pre></div><br>
</p>
</blockquote>
<p>thta'ts because <code>cargo test</code> uses your installed rust and there's a rustup mismatch</p>



<a name="218045577"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218045577" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218045577">(Nov 26 2020 at 23:41)</a>:</h4>
<p>you'd want to RTIM and then <code>cargo +master test</code></p>



<a name="218049478"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218049478" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218049478">(Nov 27 2020 at 01:16)</a>:</h4>
<p>Ah, that makes sense. But this is kind of my point: using subtrees means there are more ways to build and thus more things that you need to know.</p>



<a name="218049492"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/218049492" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#218049492">(Nov 27 2020 at 01:17)</a>:</h4>
<p>Though this conversation should be probably be moved to "Building rustdoc out of tree" or a new topic <span aria-label="sweat smile" class="emoji emoji-1f605" role="img" title="sweat smile">:sweat_smile:</span></p>



<a name="219829931"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/219829931" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#219829931">(Dec 14 2020 at 11:48)</a>:</h4>
<p><span class="user-mention" data-user-id="210316">@GuillaumeGomez</span> <span class="user-mention" data-user-id="232545">@Joshua Nelson</span>  just to complement the contact points in the blog post (going to publish the draft right now). I'll be mentioning:</p>
<ul>
<li>this Zulip stream as official (as decided some days ago, right?)</li>
<li>... with a second choice on #rustdoc on Discord (which I still se quite active)</li>
</ul>
<p>my question is, what about the #docs channel on Discord (also quite active)? Looks like a channel for helping people using and building rust documentation, correct?</p>



<a name="219832462"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/219832462" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#219832462">(Dec 14 2020 at 12:14)</a>:</h4>
<p>It's the channel for the (now removed) doc team, not rustdoc. ;)</p>



<a name="219832496"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/219832496" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#219832496">(Dec 14 2020 at 12:14)</a>:</h4>
<p>But yes, zulip as preferred way and discord as backup seems fine :)</p>



<a name="219894314"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/219894314" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#219894314">(Dec 14 2020 at 19:59)</a>:</h4>
<p>Technically, <a href="https://www.rust-lang.org/governance/teams/documentation">T-doc is still around</a>, but I have a PR to finally archive it: <a href="https://github.com/rust-lang/team/issues/487">rust-lang/team#487</a> :)</p>



<a name="220629599"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/220629599" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#220629599">(Dec 21 2020 at 20:57)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members/near/218018080">said</a>:</p>
<blockquote>
<p><span class="user-mention silent" data-user-id="344082">Nelson J Morais</span> do you want to test it out? there are some ideas in <a href="https://github.com/rust-lang/rust/issues/66581">https://github.com/rust-lang/rust/issues/66581</a> <span aria-label="smile" class="emoji emoji-1f642" role="img" title="smile">:smile:</span></p>
</blockquote>
<p>it compiles</p>
<div class="codehilite"><pre><span></span><code> Compiling rustdoc-tool v0.0.0 (D:\Code\rust\rust\src\tools\rustdoc)
     Running `rustc --crate-name rustdoc_tool_binary --edition=2018 main.rs --error-format=json --json=diagnostic-rendered-ansi --crate-type bin --emit=dep-info,link -C embed-bitcode=no -C debuginfo=2 -C metadata=fa64a24d483a6a98 --out-dir D:\Code\rust\rust\src\tools\rustdoc\target\debug\deps -C incremental=D:\Code\rust\rust\src\tools\rustdoc\target\debug\incremental -L dependency=D:\Code\rust\rust\src\tools\rustdoc\target\debug\deps --extern rustdoc=D:\Code\rust\rust\src\tools\rustdoc\target\debug\deps\librustdoc-93b08559b7720bee.rlib`
    Finished dev [unoptimized + debuginfo] target(s) in 59.19s
D:\Code\rust\rust\src\tools\rustdoc(master)&gt; .\target\debug\rustdoc_tool_binary.exe --help
</code></pre></div>
<p>but then it fails to find test-&lt;hash&gt;.dll, std-&lt;hash&gt;.dll and rustc_driver-&lt;hash&gt;.dll</p>



<a name="220629681"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/220629681" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#220629681">(Dec 21 2020 at 20:58)</a>:</h4>
<p><a href="/user_uploads/4715/oKTPreZW0q8QWYxra6noB_Sl/image.png">image.png</a></p>
<div class="message_inline_image"><a href="/user_uploads/4715/oKTPreZW0q8QWYxra6noB_Sl/image.png" title="image.png"><img src="/user_uploads/4715/oKTPreZW0q8QWYxra6noB_Sl/image.png"></a></div>



<a name="220629695"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/220629695" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#220629695">(Dec 21 2020 at 20:58)</a>:</h4>
<p>can't find those anywhere :\</p>



<a name="220629771"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/220629771" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#220629771">(Dec 21 2020 at 20:59)</a>:</h4>
<p>that's a sysroot issue</p>



<a name="220629780"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/220629780" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#220629780">(Dec 21 2020 at 20:59)</a>:</h4>
<p>sorry, most of this is out of date now</p>



<a name="220629812"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/220629812" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#220629812">(Dec 21 2020 at 20:59)</a>:</h4>
<p>if you want to use rustdoc with a hard-coded rustc version you can try <a href="https://github.com/rust-lang/rust/commit/500b0f3c1ba651f31abc551ccbcf222f48e355a2">https://github.com/rust-lang/rust/commit/500b0f3c1ba651f31abc551ccbcf222f48e355a2</a></p>



<a name="220629819"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/220629819" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#220629819">(Dec 21 2020 at 20:59)</a>:</h4>
<p>see <a href="https://github.com/rust-lang/rust/pull/79540">https://github.com/rust-lang/rust/pull/79540</a></p>



<a name="220630995"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/Recruiting%20new%20rustdoc%20members/near/220630995" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nelson J Morais <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/Recruiting.20new.20rustdoc.20members.html#220630995">(Dec 21 2020 at 21:11)</a>:</h4>
<p>will try that <span aria-label="+1" class="emoji emoji-1f44d" role="img" title="+1">:+1:</span></p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>